home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / wcron198.zip / warpcron.doc < prev    next >
Text File  |  1997-08-12  |  10KB  |  260 lines
  1.                       ┌───────────────────────────┐
  2.                       │ D O N ' T   P A N I C   ! │
  3.                       │          ;-)              │
  4.                       └───────────────────────────┘
  5.  
  6. WarpCron
  7. ────────┘
  8.  
  9.                                 WARNING
  10.  
  11. This is postcardware. It is not guaranteed to do anything, or
  12. not to do anything. Use it at your own risk.
  13.  
  14. Version: 1.98
  15. Dated  : 12 August 1997
  16.  
  17.          ────────────────────────────────────────────────────────────
  18.  
  19. This is still NOT the 2.0 version... some features that I've planned for
  20. 2.0 are not trivial and need some more brainstorming, and unfortunately I
  21. have not much time...
  22.  
  23. I decided to release a minor new release, the 1.98.
  24. Every bug users reported should be removed and some easy-to-implement
  25. new features are build in. I hope this version shortens the wait time
  26. for the 2.00 a little bit ;-)
  27.  
  28.          ────────────────────────────────────────────────────────────
  29.  
  30. Description:
  31. ────────────┘
  32.  
  33. I've ever searched a good, small, textmode scheduler for my mailbox system
  34. running under OS/2 Warp. But I didn't find anything that suits me... every
  35. other scheduler is graphical (for PM) or cruel to configure, so I decided
  36. to write my own ;-)
  37. As time passes WarpCron is now 1.98 and version 2.0 will be
  38. released in some time (hopefully with pipe-support and other nice features).
  39. I'm very glad that some other people like my WarpCron (its fantastic to
  40. get postcards from all over the world :-) ) and the more people like WarpCron
  41. the more I'll enhance it.
  42.  
  43.  * smart but rich featured scheduler
  44.  * needs nearly no CPU-Time
  45.  * can kill started programs by other events
  46.  * can reread its config during runtime
  47.  * notices a config change and reread its config then
  48.  * can edit its config directly out of the program
  49.  * can start missed events at startup
  50.    f.e. an event should run at 12:30, but you shut down WarpCron at
  51.    11:00 and start it again at 14:00. Then WarpCron can run the missed
  52.    event when it starts.
  53.  * native textmode (no PM required! Perfectly for systems with low memory
  54.    and for example TShell)
  55.  * native 32bit OS/2 application (OS/2 2.x, 3.x. 4.x)
  56.  * can start OS/2-Window, OS/2-Fullscreen, OS/2-PM, DOS-Fullscreen and
  57.    DOS (Windows?) applications
  58.  * can start applications every X minutes/hours/days/months
  59.  * can start applications NOT on a time interval
  60.    (do not run between 5:00 and 7:30 or so)
  61.  * can start applications on specific weekdays
  62.  * can start applications on a specific date
  63.  * can start applications on a semaphore (0-byte file)
  64.  * can start applocations NOT on a semaphore
  65.    (do not run if this file exists)
  66.  * can start applications manually
  67.  * can start applications minimized
  68.  * can start applications at startup and/or end of program
  69.  * writes log file with date/time
  70.  * automatically recognize a *.CMD as a progam, this means that you can
  71.    simply start a *.CMD like an EXE; you do NOT have to write
  72.    "cmd.exe /c start "bla.cmd" ".
  73.    WarpCron will do this automatically for you.
  74.  * WarpCron changes the directory when starting a program to the directory
  75.    which is specified in the event.
  76.    For example: PROGRAM          f:\utils\test\warprobot.exe
  77.    When starting this event WarpCron changes the current directory
  78.    to f:\utils\test.
  79.    Some programs require this.
  80. NEW * email support
  81.     WarpCron sends you an email if something happens (starting,
  82.     trapping...) or sends you the log of the day at midnight.
  83.     See warpcron.cfg for details.
  84. NEW * supports 4os2 and 4os2 btm-files
  85.     Just use btm-files as normal exe-files ;-)
  86.  
  87.          ────────────────────────────────────────────────────────────
  88.  
  89. NEW FEATURES / BUGS FIXED
  90. ─────────────────────────┘
  91. See file "history".
  92. Bugs fixed: see file "fixed".
  93.  
  94.          ────────────────────────────────────────────────────────────
  95.  
  96. Getting started:
  97. ────────────────┘
  98. just see WARPCRON.CFG and you will understand ;-)
  99.  
  100. Hints:
  101.  * try 'warpcron ?' for param's info.
  102.  * try key 'h' for help on keys.
  103.  * if you want to use the "kill event" feature, you HAVE TO set
  104.    StartRelated to true!
  105.    But be warned! With this option set any active program started by
  106.    warpcron will be terminated if warpcron ends!
  107.  * make an event "unmissable" with an "unmissable true;" in its config.
  108.  * you can theoretically specify up to 99 events, but 23 lines on the screen
  109.    are not enough for 99 events ;-)
  110.    So WarpCron will change to 50-lines mode if you specify more than 18 events.
  111.  * for every weekday you can specify TRUE or FALSE; but in fact just the word
  112.    FALSE is recognized by the program; so you can write everything for TRUE or
  113.    simply write nothing.
  114.  * program types are:
  115.    "w" for OS/2-Window
  116.    "f" for OS/2-Fullscreen
  117.    "p" for OS/2-PM
  118.    "d" for DOS-Window
  119.    "D" for DOS-Fullscreen
  120.    "k" for a kill event (event name to kill as parameter)
  121.  * you can lock an event for writing into the logfile with the LOG <false>
  122.    statement
  123.  * CAUTION!
  124.    DO NOT specify a RunEveryXDay or RunEveryXMon without a DATE!!!
  125.    CAUTION!
  126.  * You CAN change your warpcron.cfg while WarpCron is running!
  127.    If you change it externally, simply press 'r' on WarpCron's window or
  128.    create a semaphore and WarpCron will reread it.
  129.    The path of the semaphore has to be specified in the warpcron.cfg.
  130.    Or change it directly via key 'c'.
  131.    WarpCron can notice a config change - and reread it's config then.
  132.    So you never have to end WarpCron... perfect for 24h-systems, eh?
  133.  * DoNotRunFrom and DonNotRunUntil AFFECTS ONLY events with a
  134.    RunEveryXMin or RunEveryXHour!
  135.  * if you want WarpCron to use 25 or 50 line modes permantly use
  136.    "LargeScreen true;" or "SmallScreen true;"
  137.  
  138. Keys in WarpCron:
  139.  h      help
  140.  c      change config file. WarpCron will start the specified editor
  141.         (keyword EDIT) with its config. When finished WarpCron will
  142.         reread its config.
  143.  CAUTION!
  144.         WarpCron is NOT ACTIVE during editing! Probably an event will
  145.         be missed!
  146.  e      show an event with all parameters
  147.  l      turn logging on / off
  148.  s      start an event right now
  149.  m      toggle short infos / long infos on screen
  150.  r      reread the config right now
  151.  w      show some internal parameters
  152.  q      quit program
  153.  
  154.          ────────────────────────────────────────────────────────────
  155.  
  156. Running DOS-programs
  157. ────────────────────┘
  158.  
  159. no problem anymore :-)
  160. Just write a 'd' as ProgramType for DOS-window or a 'D' for DOS-Fullscreen.
  161. I don't know if this functions with windoze-programs too... but, who care's
  162. anyway? :-)
  163.  
  164.          ────────────────────────────────────────────────────────────
  165.  
  166. Contact
  167. ───────┘
  168.  
  169. I'm looking forward for suggestions, critics, bugreports etc.
  170. Contact me at
  171. email: julian@10vorne.shnet.org
  172. fido : Julian Buss@2:240/5210
  173. fax  : ++49-4103-91 92 55
  174. BBS  :                 55 (V34)
  175.                        54 (ISDN)
  176. Newest WarpCron is always available via file request, magic "warpcron"
  177. at 2:240/5210 (V34) or 2:240/5211 (ISDN).
  178.  
  179. This address is valid until 1/1/98.
  180.  
  181.          ────────────────────────────────────────────────────────────
  182.  
  183. Money
  184. ─────┘
  185.  
  186. This program is postardware.
  187. If this program is the thing you ever want to have, please send me a nice
  188. postcard!
  189. Send it to:
  190.  
  191. Julian Buss
  192. WG "Zehn Vorne"
  193. Tinsdaler Weg 127
  194. 22880 Wedel
  195. Germany
  196.  
  197. This adress is valid until 1/1/98.
  198.  
  199. Then I will be *very* glad :-) and send you a code via email, and the "will
  200. I get a postcard..." will change and the startup time will be shorter.
  201.  
  202. A little hint for a "wanna-be" hacker: the reg code has something to do with
  203. the famous book "Hitchiker's Guide to the Galaxy"... if you find the code on
  204. you own, please let me know ;-)
  205.  
  206.          ────────────────────────────────────────────────────────────
  207.  
  208. My english
  209. ──────────┘
  210.  
  211. hey, it's not perfect, I know ;-)
  212. If you see a big bug in this text, please email me and I'll change it.
  213.  
  214.          ────────────────────────────────────────────────────────────
  215.  
  216. Guarantee
  217. ─────────┘
  218.  
  219. no guarantee for anything except the program will take space on your harddisk
  220. (but not much ;-) ).
  221.  
  222.          ────────────────────────────────────────────────────────────
  223.  
  224. Compiled
  225. ────────┘
  226.  
  227. with VirtualPascal 1.10. A damn good pascal compiler... I just love it!
  228. The exe-file is compressed with LxLite 1.18 to save space and enhance the
  229. startup time. If you don't know LxLite... try it! It's fantastic!
  230.  
  231.          ────────────────────────────────────────────────────────────
  232.  
  233. ToDo
  234. ────┘
  235.  
  236. - writing a better documentation ;-)... perhaps somebody can do that
  237.   for me...?
  238. - running an event on special times, f.e. on 3:00, 4:30 and 8:00 or so.
  239.   Like the scheduler in Xenia.
  240.   Will be in version 2.0.
  241. - support memory semaphores, not just 0-Byte files
  242. - support for pipes, even in networks,
  243.   so that the output of the logfile cames through a pipe, too.
  244. - wildcards for semaphores ("*", "?")
  245. - DoNotRun with special dates/times (like a list)
  246.   Will be in 2.0.
  247. - global holidays / special days
  248.   Will be in 2.0.
  249. - your idea :-). Email me, if you have a good idea.
  250.  
  251. Ideas from users which I plan to implement:
  252. - a shutdown function which kills every VIO and DOS sessions and shuts
  253.   the OS/2 system down.
  254. - more than one semaphore per event
  255. - running events on every ultimo of one month
  256.  
  257.          ────────────────────────────────────────────────────────────
  258.  
  259. <Eof>
  260.